24 중첩 객체 수정하기 & update() 사용 | ✅ 편저: 코담 운영자

24-중첩 객체 수정하기 & update() 사용

- 중첩 객체 수정하기 & update() 사용

🔗 소스 1: bugbytes-io/drf-course-api

🔗 소스 2: braverokmc79/Django_REST_Framework_Series

---

1. 개요

이 강의에서는 Django REST Framework(DRF)에서 PUT 요청 시 중첩된 객체도 함께 수정하는 방법을 학습합니다. 이를 위해 update() 메서드를 오버라이딩하고, 전체 작업을 트랜잭션 처리하여 데이터 정합성을 유지하는 방식도 함께 다룹니다.

---

2. update() 메서드 구조 이해

기존에는 create()만 오버라이딩 했지만, PUT 요청으로 기존 데이터를 수정하려면 update() 메서드도 오버라이딩해야 합니다.

1️⃣ 기존 코드

class OrderCreateSerializer(serializers.ModelSerializer):

    class OrderItemCreateSerializer(serializers.ModelSerializer):
        class Meta:
            model = OrderItem
            fields = ('product', 'quantity')

	order_id = serializers.UUIDField(read_only=True)  
    items = OrderItemCreateSerializer(many=True)

    def create(self, validated_data):  
        orderitem_data = validated_data.pop('items')  
        order = Order.objects.create(**validated_data)

        for item in orderitem_data:                    
            OrderItem.objects.create(order=order, **item)
        return order                                

    class Meta:
        model = Order
        fields = (
            'order_id',   # 읽기 전용 UUID
            'user',       # 요청 시 자동 할당 (read_only)
            'status',     # 주문 상태 (ex. 'pending')
            'items',      # 주문 항목 리스트
        )
        extra_kwargs = {
            'user': {'read_only': True}  # 요청자가 자동으로 지정되므로 수동 입력 금지
        }

2️⃣업데이트 추가 코드

from django.db import transaction

class OrderCreateSerializer(serializers.ModelSerializer):
   
    ...
	items = OrderItemCreateSerializer(many=True, required=False)


    def update(self, instance, validated_data):
        order_items_data = validated_data.pop('items', None)

        with transaction.atomic():
            instance = super().update(instance, validated_data)

            if order_items_data is not None:
                # 기존 항목 제거
                instance.items.all().delete()
                # 새 항목 생성
                for item in order_items_data:
                    OrderItem.objects.create(order=instance, **item)

        return instance
        
     def create(self, validated_data):
        orderitem_data = validated_data.pop('items')
        
        with transaction.atomic():
            order = Order.objects.create(**validated_data)
            for item in orderitem_data:
                OrderItem.objects.create(order=order, **item)
        return order

   ...

• transaction.atomic() 으로 전체 작업을 하나의 트랜잭션으로 처리
• 기존 OrderItem은 삭제 후 새롭게 재생성
• items 필드는 없을 수도 있으므로 required=False, .pop(..., None) 사용

---

3. ViewSet 수정

기존의 get_serializer_class()를 확장하여 update 액션에도 동일한 serializer 사용

class OrderViewSet(viewsets.ModelViewSet):
    ...

    def get_serializer_class(self):
        if self.action in ['create', 'update']:
            return OrderCreateSerializer
        return super().get_serializer_class()

---

4. 요청 예시 (PUT)

🔗 insomia 임포트 파일 : insomnia

GET : /orders/ 요청시 주문 목록을 보면 다음과 같이 나온다.

	[{
		"order_id": "c2c96d67-cf0a-4812-a03b-71d32daf19a2",
		"created_at": "2025-06-29T14:17:42.642291+09:00",
		"user": 2,
		"status": "Confirmed",
		"items": [
			{
				"product_name": "Coffee Machine",
				"product_price": "70.99",
				"quantity": 1,
				"item_subtotal": 70.99
			},
			{
				"product_name": "A Scanner Darkly",
				"product_price": "12.99",
				"quantity": 1,
				"item_subtotal": 12.99
			},
			{
				"product_name": "Coffee Machine",
				"product_price": "70.99",
				"quantity": 1,
				"item_subtotal": 70.99
			}
		],
		"total_price": 154.97
	},
	]

✅ 따라서 PUT (업데이트) 요청 테스트하는 방법

URL은 주문 상세 경로이어야 합니다. 즉,

PUT /orders/<order_id>/


PUT
http://127.0.0.1:8000/orders/c2c96d67-cf0a-4812-a03b-71d32daf19a2/

✅ insomia 업데이트 요청 테스트

업데이트 요청 json 값

{
  "status": "Confirmed",
  "items": [
    { "product": 1, "quantity": 3 },
    { "product": 2, "quantity": 2 }
  ]
}

• items 변경 가능 (예: 수량 수정)
• 기존 OrderItem 삭제 후 새롭게 반영

---

5. 예외 처리 및 유연성

✅ PUT 업데이트 처리 요청시 "status": "Confirmed" 보내도 업데이트 처리 되어야 한다.

{
  "status": "Confirmed"
  
}

🔖 OrderCreateSerializer 의 update 에서 None 처리 때문에 가능하다.

order_items_data = validated_data.pop('items', None)

• items가 없는 요청도 유효하게 처리할 수 있도록 구현
• 존재하지 않는 경우 기존 항목 유지됨

if order_items_data is not None:
    ...  # 삭제 후 재생성
# else: 기존 항목 그대로 유지

---

6. 트랜잭션 처리 이유

• Order만 수정되고 OrderItem 생성 중 오류 나면 데이터 불일치 발생
• transaction.atomic()을 사용해 하나라도 실패 시 전체 작업 롤백됨

---

7. Delete 요청 처리

ViewSet이 ModelViewSet을 상속받고 있으므로 DELETE /orders/<id>/ 요청 시 자동 처리됨

DELETE /orders/c7a56d28-0d90-4c3e-bd63-23b4a34b6eec/
Response: 204 No Content

• 삭제 후 동일 ID로 GET 요청 시 404 Not Found 반환됨

---

8. 요약

• update() 메서드를 오버라이딩해 중첩 객체 수정 처리
• items가 요청에 포함되지 않으면 기존 항목 유지
• 트랜잭션으로 데이터 일관성 보장
• ModelViewSet으로 DELETE도 기본 제공

다음 강의에서는 serializer 필드 설정을 좀 더 세밀하게 다루고, 캐시 및 Redis 설정을 활용한 성능 최적화를 진행합니다.